Skip to content

docs(tool-executions): fix an invented env var and a wrong host that just merged - #1160

Merged
josebarrueta merged 1 commit into
add-doc-screenshotsfrom
plt-3107-logging-policy-rename
Aug 28, 2026
Merged

docs(tool-executions): fix an invented env var and a wrong host that just merged#1160
josebarrueta merged 1 commit into
add-doc-screenshotsfrom
plt-3107-logging-policy-rename

Conversation

@josebarrueta

@josebarrueta josebarrueta commented Aug 28, 2026

Copy link
Copy Markdown
Contributor

#1157 merged ten minutes before its own correction landed. add-doc-screenshots currently carries two errors I introduced; this fixes both.

Time (UTC)
17:45 pushed 8e7c9a33$ARCADE_ACCOUNT_TOKEN, api.arcade.dev/v1/...
18:00 #1157 merged
18:10 pushed 7fba7342 — the correction, which missed the merge

What is wrong on the branch right now

curl -s -X PUT "https://api.arcade.dev/v1/orgs/{org_id}/logging-config" \
  -H "Authorization: Bearer $ARCADE_ACCOUNT_TOKEN" \

$ARCADE_ACCOUNT_TOKEN does not exist. I invented it. It appears nowhere in the product or on this site. A reader would export nothing, get a 401, and have no name to look up.

The URL is wrong in host and prefix. logging-config is a control-plane route. Every other one on this site is cloud.arcade.dev/api/v1/; a live stack returns 404 for /v1/orgs/... and resolves /api/v1/orgs/....

What this changes it to

curl -s -X PUT "https://cloud.arcade.dev/api/v1/orgs/{org_id}/logging-config" \
  -H "Authorization: Bearer $ARCADE_API_KEY" \

$ARCADE_API_KEY matches the audit log page, which documents the same org-scoped shape as "User (API key/JWT)". The surviving, verified claim is narrower: a project key is refused with 401 Invalid credentials: missing account ID, and the prose now says so.

How this happened

I hit that 401 while testing with a project key from the fixtures, concluded the documented credential was wrong, and invented a replacement without checking that it existed. The check I skipped was one grep of the sibling page.

Worth reviewing this one on the diff rather than the description.


Note

Low Risk
Documentation-only fix for copy-paste API examples; no product or runtime behavior changes.

Overview
Corrects the Recording and retention → Change them yourself example so org logging policy updates match how other control-plane routes are documented.

The curl example now uses https://cloud.arcade.dev/api/v1/orgs/{org_id}/logging-config instead of api.arcade.dev/v1/..., and $ARCADE_API_KEY instead of the nonexistent $ARCADE_ACCOUNT_TOKEN. The surrounding text now points readers to the same org-scoped user auth model as the audit log API and states that a project API key gets 401.

Reviewed by Cursor Bugbot for commit 18b2a17. Bugbot is set up for automated code reviews on this repo. Configure here.

…d variable

The previous commit introduced `$ARCADE_ACCOUNT_TOKEN`, which is not a thing —
no such variable exists in the product or anywhere else on this site. The audit
log page documents the same org-scoped shape as "User (API key/JWT)" with
`$ARCADE_API_KEY`, so that is what this uses, with a pointer to it and a note
that a project key is refused.

The URL was wrong from the start, in both host and prefix. `logging-config` is
a Coordinator route, and every other Coordinator `orgs/` call on this site is
`cloud.arcade.dev/api/v1/`; only this page said `api.arcade.dev/v1/`. A live
stack returns 404 for `/v1/orgs/...` and resolves `/api/v1/orgs/...`.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 28, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docs Ready Ready Preview Aug 28, 2026 8:17pm

Request Review

@josebarrueta
josebarrueta merged commit 6915182 into add-doc-screenshots Aug 28, 2026
8 checks passed
@josebarrueta
josebarrueta deleted the plt-3107-logging-policy-rename branch August 28, 2026 20:18
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant